<?php
/**
 * @author jonathan poelen <jonathan.poelen@gmail.com>
 * @version 1.0: jo_link_noir
 * @date 28-10-2009
 */
interface SW_Resource_DAO_Interface
{
	/**
	 * @param int $ref_planet
	 * @param int $id_structure
	 * @param int $group
	 * @param int $quantity
	 * @param int $time_end
	 */
	public function create($ref_planet, $id_structure, $group, $quantity, $time_end);

	/**
	 * @param array $resource : {id => int}
	 */
	public function increaseQuantities(array $quantities);

	/**
	 * @param array $resource : {id => int}
	 */
	public function decreaseQuantities(array $quantities);

	/**
	 * Sélectionne les ressources d'une planète
	 * @param int $id_planet
	 * @return array : {U1_Resource_Element, ...}
	 */
	public function selectAllInPlanet($id_planet);

	/**
	 * Sélectionne les ressources de toutes les planètes d'un joueur
	 * @param int $id_user
	 * @return array : {id_planet => {U1_Resource_Element, ...}, ...}
	 */
	public function selectAll($id_user);
}